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Where did you buy your SPDOS/KDOS 
interface? Where did you see it adver- 
tised? How did you find out about SURF? 
Well, I bought mine from Watford Elec- 
tronics, but I had to work hard to find 
an advertisement. Truth to tell, I first 
saw a SPDOS interface when I went to buy 
a Morex printer interface and had the 
prototype SPDOS demonstrated for me. I 
couldn't afford it at the time, but later 
on, when I was thinking of using disks 
(I'd returned the Wafadrive after only 
two weeks!), I remembered the SPDOS 
interface and phoned Abbeydale (via 
Morex). to see where I could get one. I 
was referred to Watford and eventually 
became a happy and proud owner.... But at 
the» same time I found it much easier to 
get hold of advertising literature on 
Beta+, Discovery and even Timex inter- 
faces. But they hadn't got the excellent 
specification (as, of course, you know). 
Well, it didn't worry me as I'm not 
concerned with Abbeydale and if they 
don't sell enough interfaces it doesn't 
worry me. 


However , I reviewed the  SPDOS 
interface for Micronet on Prestel (the UK 
Viewdata service) and they asked me to do 
another on the KDOS interface when it 
came out. This I did, and spent some time 
talking to Dave and Dimitri about it. 
Well, you know how it is. You meet a 
couple of guys who are obviously ace with 
a lovely product which appears to be 
marketed by loonies. To be fair, Watford 
spent a lot of time and money and thought 
with SPDOS and the advertising was OK if 
you knew where to look. But SPDOS is too 
good to restrict it to the average games 
player! It adds an extra dimension to the 
Spectrum and makes it into an impressive 
and useful little system (why do I tell 
you this. ...). 


Watford were (and are) wedded to the 
B**b and other A**™ products, so it 
wasn't surprising that they didn't seem 
to go overboard with SPDOS. But Kempston 
is another matter. You have to search 


really hard to see any reference to KDOS ` 


anywhere in Kempston ads. ‘And Big K's 
version of the handbook was (is) pathetic 
with loads of misprints. And there's no 
bundled software (SPDOS, you remember, 
had tasword 2, Masterfile, Omnicalc and 
an AD filing prog included on the system 


master disc). And no reference to SURF - 
at least, Kempston omitted to” send out 
SURF application forms with a good number 
of KDOS inter- faces (so that many people 
are missing one of the big advantages of 
the RAM based system and can't get hold 
of the updates and utilities, let alone 
all the useful hints and tips in these 
hallowed pages). 


To cap it all, some of the KDOS 
interfaces are unreliable. Graham Mills 
(one of Dimitri's friends in Reading) had 
to try three or four different interfaces 
before he got one which would save and 
load reliably. Tony Brooks from the USA 
has also been having trouble with his 
2068 with Spectrum ROM + KDOS. Dimitri 
identified Graham's problem as one of 
poor manufacture. In fact a score or more 
of dry joints and bad connections were 
making his KDOS crash and corrupting his 
discs. Dimitri reckons that the best 
thing to do is to send the offending 
interface back to Kempston and demand one 
that works. The standard of manufacture 
doesn't always seem as good as it might. 
A well-built KDOS is an inherently 
reliable and powerful system. 


So, what's to do? Watford won't and 
Kempston can't! AIl- I can say at the 
moment is to watch this space. 
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* ADvance with AD! * 
HH HH HH K HK 
<<<<from ABREYDALE DESIGNERS>>>> 


Membership of SURF -——. quite a few of 
our members will need to renew. their 
subs with this issue of SURFnews. Just 
to remind you, Dave has- enclosed a 
little slip with the details. So look 
out for it! 

SYSTEM DISCS are still available at 
$15.00. You can have SPUD on it (see 
SURFnews 3) for another £15 and for yet 
another £5 you can have a copy of 
O'Farrell's Disk Sector Editor (see last 
page of this. SURFnews) all ‘on the one 
disc!! The Editor on its own (on tape) 
costs £8.00. 

All from ABBEYDALE DESIGNERS, PO Box 124 
READING, BERKS, RG4 OLF, UK 


© 


---a word processor from Myrmidon 


The Myrmidons were a race of warriors 
fron Thessaly whom Achilles took with 
him to fight at Troy. But at Troy, 
Achilles spent large amounts of time in 
his tent, disaffected. Nick Buckenhan, 
who wrote "The Last Word..." (or TLW as 
the afficionados seem to call it) used 
to call his terriers the Myrmidons, and 
regarded them with such affection that 
he called his software after them. As 
far as I'm concerned, Nick has spent 
some time in his tent since then, as I 
didn't come across TIW until Dimitri 
dusted off a pile of disks and said 
"Look at this one". Then, without the 
aid of the instruction manual (or even a 
safety net), big D took me on a swift 
tour of TIW for KDOS. To say I was 
impressed would be an understatement. As 
soon as possible, Nick was sat in my den 
demonstrating his brainchild. 


I've had experience of a number of 
word processors, mainly tasword II and 
Quill, but have also spent a bit of time 
on Applewriter and Spectralwriter and 
have helped one of our secretaries at 
work find her way around a Rank-Xerox 
machine. I've also seen the reviews on 
tasword III but of course haven't tried 
to use it since it won't run on 
SPDOS/KDOS. Of all these, TIW compares 
most closely with Quill. In fact the 
only things TIW won't and can't do which 
Quill does are flexible tabbing (TIW 
does it in selectable but constant 
increments and can't vary the type of 
justification at the tab points) and it 
can't vary the design of page. A number 
of other functions aren't directly 
supported (eg pagination, headers and 
footers) but these can be spliced in by 
means of a unique (as far as I know) 
system whereby control codes can be 
embedded in the text which will drop the 
printer into control by BASIC. Each code 
points to a line in BASIC which you set 
up beforehand and which can contain 
instructions or further bits to be typed 
(including control by loop variables, 
etc). This system of breaking out from 
machine code (which gives speed but most 
people can't manipulate it readily) into 
BASIC (which is slow but malleable) 


makes TIW a very powerful word 
processor. It is almost totally 
adaptable. Nick likes to think of this 


approach as "openness". To compare it 
with tasword, tII is so open as to be 
falling apart (and hasn't got many of 
the facilities -— you have to keep 
breaking out of it) and tIII sounds to 
be a totally closed system! This does 
mean that you have to be moderately 
intelligent and flexible to use TLW, but 
it is a tool, not a game! 


In the three days I have been using 
TLW I have liked: 

- the flexibility of the display. You 
can go from 40 to 48 to 60 to 80 columns 
with 3 or 4 key presses. Each of those 
displays can cope with any line length 
up to 148 characters with all the text 
on the screen. Lines are folded on to 
the screen with markers to show where 
the line ends. 

~ the typefaces. These are extremely 
clear which is a great help to accurate 
typing - you can actually see what you 
have written! The 40 and 48 pitch ones 
are particularly pleasing which is no 
surprise since Myrmidon's first essay in 
software was "microprint" as used in 
MasterFile. 

- the way the keyboard is linked to 
the display. There is a small buffer so 
that as you turn the corner at the end 
of a line you keep on typing as fast as 
you like and the system catches up when 
it can. With tasword I often found a 
letter dropping out from the first word 
in a line. 

- the ease with which you can form up 
your printing - just press the "reform" 
button and all the glitches and spaces 
in the paragraph disappear. 

- the way you include printer 
commands: they don't change the line 
length and a little prompt line 
displays the function of that particular 
command. It also does it when you scan 
through text, simply by placing the 
cursor on it. 

- the word 
function 
(though 
case and capital letters) as 
block move. 

- the quality of spacing of the 
words. TaswordII just adds spaces from 
the right which gives the page an 
unbalanced appearance, being darker to 
the left and lighter to the right. Nick 


search and replace 

is very fast and powerful 
it differentiates between lower 
is the 


isn't quite satisfied with this aspect 
yet, but it is probably as good as you 
can get without proportional spacing. 

- the error-trapping and "escape" 
button. You can't easily step out of 
line without being beeped at and the 
question "what?" appearing. This makes 
what might be a relatively delicate 
program (alot of it is apparently in 
interrupt mode 2, which is supposedly a 
bit of a balancing act!) into an 
extremely robust one. I often crash 
tasword II if I don't concentrate. 


But I didn't like: 

- the way the left margin changes if 
you are doing a lot of reforming of the 
text. Typically the margin changes from 
1 to 4, but you can't tell! (Nick knows 
of this problem but doesn't know the 
answer). 

- the fact that the end-of-line text 
markers can screw up the reforming and 
you can't tell where they are! (to be 
fair, as you get better with TWL this 
problem comes up less often). 

- the fact that the printer control 
code tahle crashed on me three times in 
a row (nq idea why but it happened in 
the same way each time so is presumably 
an obscure bug). 

- the fact that it only runs on KDOS 
at present (this is Dimitri's interface 
I'm using at the moment) but I think 
I've persuaded Nick to incorporate the 
AD miniDQS. 

As soon as he's done the conversion I 
shall ditch all my tasword files and go 
over entirely to TIW. It can be quicker 
than Quill to use (you have to wait 
while the screen reforms itself with 
Quill if you are in the full prompt 
screen, though it's obviously quicker if 
you run in the no-prompt mode) and the 
typeface is nicer to look at if you 
can't afford a monitor. Obviously Quill 
is a professional quality word processor 
but TIW isn't far behind. Considering 
the price it's an amazing bargain! 


Of course, this review is somewhat 
superficial in that I have mentioned 
only about half the features of TIW... 
If you want more information then write 


to Saga Systems Ltd. 


"TIW..." is available by mail from 
Saga Systems ltd, 2 Eve Rd, Woking, 
Surrey, GU21 4JT, UK, cost £13.95 on 
cassette. j 


***GETTING L-FORTH TO RUN*** 


Francis Glassborow 


If you have had difficulties using 
the version of L-FORTH on the AD utili- 
ties disc (SPUD) the following may help: 


1. System resets immediately Probably 
caused by using interrupt mode 2 with 
hardware that is disturbing the ULA's 
use of the address lines. POKE 
42629,140: POKE 42631,150 will modify 
the code so that it will start up in 
IMi. Provided you are using a Spectrum+ 
or a Spectrum 48k (ie one with the 
section of ROM filled with $FF) then the 
following FORTH routine will reinstate 
IM2. safely: 

a. First use CONFIGURE to lower 
FORTH's RAMtop to 65523 or less, 

b. then use the editor to prepare a 
screen with the following entries: 

HEX 18 FFFF C! (set last byte of RAM 
for JR...first byte of ROM will then 
send PC to 65524) 

C3 FFM C! AS5AO FFFS ! (set up JP to 
interrupt routine) 

39 A598 C! (new value for I reg) 

FIND IMODE DUP 20 SWAP ROT 2! (reset 
IMODE for IM2) 

DECIMAL IMODE (implement) 

as) 

? 

LOADing this screen will now restore 
IM2 facilities so that the correct 
interrupt address will be used 
regardless of the address generated by 
the ULA. 


2. Protect does not work The released 
version of PROTECT does not work with 
version 2.4E. The following short patch 
corrects the problem (note that if you 
rel0AD the source code you will need to 
change the two occurrences of 40233 to 
40231 first). 

40231 DUP 57369 ! 57445 ! 


3. RAMtop no good If you get this 
message you may need to recover some of 
the workspace used by ZED. If you have a 
Timex 2068 you will have to do this as 
the Timex's organisation of RAM makes my 
initial memory map unusable. 

a. Change all addresses in the range 
24000 to 27000. in the BASIC support 
program by increasing them by 1000 (any 
greater change will require rather more 
extensive changes to ZED and other 


@ 


routines 
space. 

b. Now modify WRITE, ->Z and Z-> to 
cater for the new start of ZED's work- 
space. Either change the source code and 
recompile or use EXPAND to locate the 
vital bytes to be changed. These will be 
constants so the effective change mst 
be at the listed address +2. The 
critical addresses are 26xxx which must 
become 27xxx. In addition 6144 in WRITE 
must become 5144. 

Ce If you are going to use the 
distributed tape source code files you 
will need to change line 61 of BASIC so 
that they will be loaded back to the new 
address given in the modified line 60. 
You can also recover a lot of space by 
removing all lines of BASIC that are 
unused by your set-up, but if you pass a 
copy on please include the original 
BASIC so that the recipient has a 
complete version. 


currently using ZED's work 


I hope this helps if you are trying 
to get the software to work without a 
manual. 


4 REM G.A.MILLS March 1986 

10 REM File Sort and Move 

20 PRINT TAB 2;"File Move G. 
A.Mills 1986" 

30 PRINT #4: OPEN 42,"auto" 

40 PRINT #4: CAT 

50 PRINT #4: CLOSE #2 

60 PRINT #4: OPEN #6,"auto" 

70 INPUT #6;f$:: PRINT AT 2,11; 
£$(15 TO ) 80 FOR a=1 TO 5: INPUT 
#6;£$: NEXT a 

90 INPUT #6;d$:c$: PRINT TAB O; 
d$;TAB 15;e$ 

100 INPUT #6;a$ 110 IF CODE a$=0 
THEN PRINT #4: CLOSE #6:: PRIN T 
#4: ERASE "aut o": STOP 
120 INPUT #6;b$:c8 

130 PRINT TAB O;a$;TAB 8;b$; TAB 

- 153c$ 

140 PRINT #1;"Do you wish to Mo 
this File Y/N" 

150 PAUSE O : IF INKE Y$="Y" OR 


INKEY$ ="y" THEN PRINT #4: MOVE 
c$ (2 TO ),"": PRINT 1,21 
160 GO TO 100 


Dear Julian, 


About the KDOS CAT program you asked for 
in a previous SURFnews - here it is! It 
transfers the file names of all the 
BASIC programs onto the disc in a 
sequential CAT after LOADing RUN 320. 
Then whenever the program is called on a 
reset it will display the file names in 
alphabetical order in fields of 26 file 
names suffixed with a letter (A to Z). 
At the bottom of the field is "Is the 
program you require in this Field? Y/N". 
Pressing "N" causes the next field to be 
shown; "Y" prints a request to press the 
suffix letter of your chosen program. 
When you press it, that program is 
loaded. When programs are added or 
removed the program file can be 
refreshed simply by entering: 
PRINT#4 :ERASE "cat" :RUN 320 

If the erase command is added at line 
315 then RUN 315 would suffice. It mst 
be RUN in order to reset the program's 
variables. The program is capable of 
handling all the possible 144 entries on 
a disk but the maximum capacity for 
other programs is obviously 142 since 
this program and the "cat" file take two 
entries. The bubble sort at line 240 
takes about 30 seconds. If you are happy 
with a non-alphabetical listing alter 
line 70 to GO TO 100 and the cat will be 
up in less than 10 seconds. This is 
faster than a comparable program using 
DATA statements. 


The other program 
"MOVEFILE" which I find useful when 
doing disk housekeeping. It reads a 
"cat" into a sequential file "auto" and 
then offers you each file name complete 
with all the "cat" data - i.e. file 
type, length and name. You have only to 
say "yes" and it will move the file from 
the source disk (always drive 1) to the 
destination disk (always drive 2). I 
believe the program will operate with a 
Single drive and prompt when the change- 
over is required. When you have been 
right through the listing answering yes 
or no, the program removes its file 
"auto" and STOPs at line 110. It can 
then be re-RUN for another disk. The 
maximum size of program is 38k. 


is a utility 


Best wishes, 


Graham Mills 


10 POKE 23609,0: POKE 23608,0 
15 PRINT PAPER 5, IWK O 
20 PRINT #4:0PEN #6,"cat"' 
30 DIM a$(144,11): LET a=1 
40 INPUT #6:f$: PRINT AT 0,123 
"DISC CAT "sAT 2,103£$(15 TO ) 
50 FOR a=1 TO 144 
60 INPUT #6;a$(a) 
70 IF CODE as(a)=0 THEN PRINT 
#4: CLOSE #6: GO TO 100 
80 NEXT a 
90 STOP 
100 LET z=0 
110 LET b=1 
120 FOR f=2 TO a-1 STEP 2 
130 IF £/2=INT (£/2) THEN PRINT 
AT b+3,2;CHRD (64+(f-2-1))¿" "; 
aS(f-1);TAB 19:CHR$ (64+f+z)3" " 
¡as(£) l 
140 LET b=b+1: IF bx=14 THEN PR 
INT #1;"Is the PROG you want on 
this FIELD Y/N": PAUSE O: GO TO 


290 

150 NEXT f 

160 IF f>a+1 THEN LET f=f+1: IF 
f<>a THEN GO TO 180 

170 IF (£)/20INT ((£)/2) THEN 
PRINT AT b+3,23CHRS (64+f=2)3" " 
¡as(£) 

180 PRINT 40;"INPUT LETTER TO L 
OAD": PAUSE O 

190 LET ans=CODE INKEY$: IF (an 
s<65 OR ans»a+122) THEN GO TO 19 
0 

200 IF ans>9 THEN LET ans=ans- 
J2 

210 IF ans>(a+64) THEN GO TO 18 
O 

230 PRINT #4: LOAD a$((ans-64+z 
),2 10) 

240 LET b=0; FOR c=1 TO a-2 
250 IF a$(c)>a$(c+1) THEN LET b 
=1; LET prats IET a$(c)=aS(c 
+1): IET aS(c+1)=b$: NEXT c 

260 NEXT c 

270 IF b<>O THEN GO TO 240 

280 GO TO 100 

290 IF INKEYS="Y" OR INKEYS="y" 
THEN GO TO 180 

300 IF INKEY$="N" OR INKEYS="n" 
THEN LET b=1: LET z=z+26: CLS : 
PRINT AT 0,12;"DISC CAT":AT 2,1 
O:f$(15 TO ): GO TO 150 

310 GO TO 290 

320 PRINT #4: OPEN #2,"cat" 
330 PRINT #4: CAT 

340 PRINT #4: CLOSE #2 

350 POKE 23609,0: POKE 23608,0 
360 PRINT #4: OPEN #6,"cat" 
370 PRINT #4: OPEN #8, "temp" 


: PRINT #6,f$ 

: INPUT #6; f$: 
400 INPUT #6;f$ 
410 IF CODE f$=0 THEN PRINT #6; 
CHR$ O:: PRINT #4: CLOSE #6:: PR 
INT #4: CLOSE #6:: PRINT #4: ERA 
SE "cat":: PRINT #4: MOVE "temp" 
"cat": STOP 

420 IF f$="Basic" THEN GO TO 44 
O 

430 GO TO 400 

440 FOR b=1 TO 2: INPUT #6;a$: 
NEXT b: PRINT #8;a$: GO TO 400 


**Simon's Cat ** 


To use the program, type it in 
exactly as listed on the next page,then 
change the basic loader programs on your 
disc to be pre- fixed with a "!" - e.g. 
I SCRAMBLE. RUN the program, which will 
then make a file on the disc of a 
CATalogue of the disc called "." (this 
filename can be changed if you want by 
changing lines 50 & 130). It does this 
because a CATalogue of the disc is not 
immediately accessible to BASIC so it is 
necessary to read the CAT from a file. 
Then the program loads all the filenames 
prefixed by a "!" (this can also be 
changed by altering lines 100 & 380) 
into an array. The program then erases 
"." and the mem part of the program 
takes over. It is not necessary to copy 
the program on to each disc, so long as 
the BASIC loader programs required are 
prefixed with "!" or whatever symbol you 
have chosen. All you have to do, with 
the program still in memory, is to press 
symbol-shift-5 (i.e."%") and the program 
will copy itself onto the disc and 
produce the mem for that disc itself. 
Do not worry if the program takes 
several seconds to produce the mem 
initially as it does not go through all 
that rignarole each time it is accessed. 
The data is stored in the program in its 
array. It will be necessary to insert 
POKE 23611,204 in line 150 if you still 
have version Vi.1 of SPDOS. 


Simon Hart 


EÈ 


10 PRINT #0:TAB 10; FLASH 1:"P 
lease Wait": PRINT #4: OPEN #2," 
ti 
20 PRINT #4: CAT 
30 PRINT #4: CLOSE #2 
40 DIM BS(40,10): DIM T$(8,30) 
50 PRINT #4: OPEN #10,"." 
60 FOR S=1 TO 8: INPUT #10; LI 
NE TS(S): NEXT S 
70 LET X=1 
80 INPUT #10; LINE I$ 
. 90 UF CODE I$=0 THEN GO TO 120 
100 IF I$(18)="!" THEN LET B$(X 
)=1$(19 TO LEN I$): LET X=X+1 
110 GO TO 80 
120 PRINT #4: CLOSE #10 
130 PRINT #4: ERASE "." 
140 PRINT #4: SAVE "AUTO" LINE 
150 
150 CLS 
160 PAPER Os INK 7: BORDER O: C 
IS 
170 PRINT INVERSE 13" SPDOS Dis 
c Auto-Program Loader" 


180 PRINT TAB 3; INVERSE 15"DIS. 


C NAME :— "¿T8S(1)(16 TO 25) 

190 PRINT 

200 FOR F=1 TO 30 STEP 2 

210 IF BS(F)( TO 1)=" " THEN GO 
TO 260 

220 PRINT BRIGHT 13" ";CHR$ (F+ 
64); BRIGHT 0;" - ";BS(F), 

230 IF BS(F+1)( TO 1)=" " THEN 
PRINT : GO TO 260 

240 PRINT BRIGHT 1;" "sCHRS (F+ 
65); BRIGHT 0;" — ":BS(FH) - 
250 NEXT F 

260 PRINT : PRINT TAB 2; BRIGHT 
13"6": BRIGHT O;" - Init. "; B 
RIGHT 1;"#"; BRIGHT O;" - Cat " 
: BRIGHT 1;"$"; BRIGHT O;" — Bas 
ic" 

290 PRINT : PRINT 

300 PRINT TAB 3; INVERSE 1;"SEL 
ECT PROGRAM ?": INVERSE 0," "; 
310 PAUSE O 

320 IET I$=INKEY$: LET I=CODE I 
$: LET I=1-96 

330 IF I$="$" THEN PRINT #0; BR 
IGHT 1;" Key RETURN to conti 
nue": PAUSE 100: GO SUB 9999: GO 
TO 150 

340 IF I$="%" THEN RUN 

350 IF I$="#" THEN PRINT #4: CA 
T <: PRINT #0; BRIGHT 1;" 
Press any key": PAUSE O: GO TO 
150 ` 

360 IF I>=F+1 OR I<1 THEN GO TO 
310 
370 PRINT BRIGHT 1;B$(I) 
380 PRINT #4: LOAD "!”+B$(I) 


<<<<DISK SECTOR EDITOR>>> . 


This program, written in Pascal by 
V.A. O'Farrell for SPDOS disc 
systems, will supplement vimitri's 
articles in this and the next issues of 
SURFnews. Because although the PRINT 
"filename" function on the SPUD disc 
gives adump from the disc to screen, 
with ASCII, this sector editor will do 
just that - lift out and display sectors 
(128 bytes at a time) for you to edit 
and resave as you like. So you can play 
around with the SPDOS system and also 
patch and reclaim discs, following 
Dimitri's outline of the system. The 
commands enable you to select a sector 
to read, which is then displayed in four 
screens which you page through by 
pressing SPACE. The cursor appears as a 
black square with the character it 
covers (representing a nybble) appearing 
white within it. The cursor can be moved 
in all four directions and the nybble 
changed simply by pressing the 
appropriate key (1-9, A-f). The modified 
sector can then be resaved. Unfortu- 
nately (I suppose it's unfortunate) I 
didn't have a corrupted disc to test to 
see if I could use the editor to patch 
it. So I don't know how far a disc can 
be corrupted before it becomes irre- 
deemable. Perhaps if you buy a copy of 
this program and find you have to use it 
in anger, you could drop a line to SURF, 
c/o Abbeydale Designers, and let us know 
how you got on. In the meanwhile, the 
program is available on tape from 
Abbeydale Designers, PO Box 124, 
Reading, Berks, RG4 OLF, UK. 


>>>>SURFnews< <<< 


This is the fourth edition of 
SURFnews, and it's late again! In fact I 
think Abbeydale Designers said that the 
news letter would be quarterly. Sorry 
about that, but I don't think it means 
that you get any less for your 
subscription. The first SURFnews was 6 
sides, the next 8, then 10, and this one 
is 12! Remember that this is a club 
magazine, so if you have any software, 
peripherals etc. to advertise, we don't 
charge to print your ad. The 
subscription rate is 115.00 a year which 
covers SURFnews and help with 
troubleshooting your SPDOS/KDOS system. 


***STRUCTURE OF THE SPDOS DIRECTORY*** 
by Dimitri Koveos 


In the SPDOS manual I attempted to 
give a simple definition of a DISK OPER- 
ATING SYSTEM (DOS) as the supervisory 
programs which allow you to refer to 
data onthe disk as FILES rather than 
tracks and sectors. The DOS allocates 
the space required for a particular 
file, in terms of ALLOCATION UNITS (AUs) 
or GRANULES. An AU corresponds to two 
contiguous sectors and is, therefore, 
one kilobyte long. Track 20 (physically 
the 21st track of the disk) is reserved 
by the DOS for the DISK DIRECTORY. This 
directory contains information such as 
the specification of the disk (name, 
number of tracks, sectors and sides, 
stepping rate, etc), the allocation of 
space, the HASH INDEX TABLE (HIT) and 
the specifications of all individual 
files. 


Before going any further, let's make 
something clear: A double-sided disk has 
two useable surfaces so that a given 
track number (say, 20) corresponds to a 
track on beth top and bottom surfaces. A 
"side-selec;" signal mst be issued to 
instruct the drive as to which of the 
two surfaces we wish to access. Quite 
often the term CYLINDER is used for the 
tracks on any one surface so that a 
40-cylinder disk consists of 40 tracks 
it it is single-sided or 80 tracks if it 
is double-sided. SPDOS handles the 
second side of a double-sided disk as an 
extension of of the first side, each 
track being treated as twice the length 
- ie 20 sectors instead of 10 each. This 
strange arrangement doubles the size of 
a disk, unlike the BBC DFS which treats 
the second side asa different drive. 


Now, back to the SPDOS directory. Its 
total length is 10 sectors (O to 9 - ie 
one side of track/cylinder 20) with 
sector O containing the mein information 
about the disk. The remaining 9 sectors 
are available for individual file 
entries. 32 bytes are used for each 
entry making (9 x 512)/32 = 144 as the 
maximum number of entries. Sector 0 is 
used as in the next colum: 


bytes 
O-2 not used (filled with zeros) 
3-12 Name of disk (10 characters) 
13 - 14 zeros on non-system disks 
15 zero 
16 80 hex 
17 - 18 zeros on non-system disks 
19 - 26 zeros 
27 A5 hex 
28 retry count (usually 50) 
29 number of tracks 
30 number of sectors-1 (norm.9) 
31 number of sides-1 (O or 1) 
32 stepping rate-1 (O to 3)' 
35 01 
34 - 35 disk capacity in k (ISB/HSB) 
36 =- 40 A5 hex on non-system disks 
41 - 9) A5 hex 
96 ~ 255 allocation unit table (AUT : 
or GAT) 
256 - 511 hash index table (HIT) filled 
with zeros - only first 144 bytes are 


used. 


The ALLOCATION UNIT TABLE 


This table is known as the AUT or GAT 
(granule allocation table). Fach byte 
corresponds to 8 allocation units (8k) 
with the first byte corresponding to the 
first 8k on the disk. The space on the 
disk is mapped logically so that maps, 
sectors and sides become irrelevant: the 
whole disk is seen as a continuous block 
of allocation units or granules. For 
example, a40 track, single-sided disk 
consists of 40 x 5 = 200 gramles, 
numbered O to 199. A double-sided, 40 
track disk will have 400 granules (0 to 
399). The directory occupies granules 
100 to 104 on a single-sided disk or 200 
to 204 on a double-sided one. The GAT is 
a collection of as many bits as there 
are granules. A free granule is marked 
by clearing its allocation bit while a 
used granule is marked by setting it. 
For exampie, if a disk has its first 17k 
allocated, the beginning of its GAT will 
look like this: 


TEATRE DAA AE Pe 


which of course, in terms of bytes, will 
be FF FF 80. Now let's work in reverse. 
The GAT for a certain disk looks like 
this - FF DF 7F OD 00 etc - as a bit-map 
01111111 00001101 


11111111 11011111 


00000000 


Assuming a single-sided disk, the 


bit- map means: 


Track# Allocation units 
01234 
XXXXX 
RARO 
Oxxxx 
XOX 
Xx xO 
000xx 
Ox000 


DUE NO 


You can mark granules as allocated 
using a sector editor, working out their 
entries in the bit map and setting them 
to 1. In this way you can have your own 
protected sectors on the disk, outside 
the jurisdiction and control of the DOS. 
Obviously you can only access these 
sectors directly and not as files via 
the directory. When a file is saved to 
the disk its size is converted to the 
number of granules, rounded up. The GAT 
is then searched for a continuous free 
block which will be large enough to take 
the file. If such a block is found, the 
file is saved and the map bits 
corresponding to this disk area are set 
to mark it as allocated. The absolute 
"address" of the first granule, as well 
as the total number of contiguous gan- 
ules used, is stored in the directory 
entry of the file. 

If the disk is nearly full and a 
continuous block of free space does not 
exist, the file is saved in a fragmental 
form using the largest available single 
block, then the next largest and so on 
until the whole file is stored on the 
disk. These fragnents are known as 
"extents". The characteristics (start 
granule, length) of up to three of them 
are stored in the directory entry of the 
file. If more than three extents are 
necessary an additional directory entry 
is created for the next three. This 
entry is knowm as a FILE EXTENT DIRK- 
TORY ENTRY (FXDE). Each time a FXDE is 
created, the total number of DIFFERENT 
directory entries is reduced by 1. Very 
often when small files are frequently 
saved and erased on a full disk, files 
are very likely to be fr nted, even 
with files just over 1k (1 granule). 
Your disk can easily be tidied by making 
a backup (global MOVE) onto a blank 
formatted disk. MOVE copies files, not 
bits, so it copies fragnented files as 
single blocks until it once more has to 
generate extents. 


***THE HASH INDEX TABLE 


When you specify a filename for LOAD- 
ing, SAVEing, ERASEing, etc, each entry 
in the directory mst be searched for a 
match. 

SAVEing- if a match is not founda 
new entry is created (similarly with 
sequential OPEN A). With all other 
operations the report “Record not found" 
is returned. 

With a directory structure like that 
of SPDOS which supports up to 144 files 
it can take quite a long time to to 
search for a 10-character filename. 
There isa short cut to locate a file 
rapidly without going through all the 
directory entries. This involves a HASH 
INDEX which is an 8-bit number produced 
by operating on the filename via a 
"hashing" algorithm. When a file is 
generated its hash code is generated and 
stored in the Hash Index Table in a 
position which corresponds to the direc- 
tory entry for that file. Thus the first 
HIT entry corresponds to the first 
directory entry, the second to the 
second, and so on. The hash codes. can be 
between 1 and 255 with O indicating a 
deleted or nonexistent entry. When a 
file is accessed, its hash index is 
produced by the same algorithm. This 
code is then used to search through the 
HIT. If a match is not found, the file 
does not exist. If a match is found the 
position in the HIT is used as an index 
to the appropriate directory entry where 
a full comparison is made with the 
filename. If this comparison fails then 
the HIT has to be searched for another 
match. This is likely to happen (though 
not often) because the limited range of 
hash codes makes it impossible to 
produce unique codes for all filenames 
on a disk. 

Here is a short BASIC program which 
will allow you to generate the hash code 
for any filename and print it in hex: 


10 CLS: FOR i=O TO 22: READ a: PO 
KE 23296+i,a: NEXT i 

20 DIM £$(1,10): LET h$="'01234 56 
189ABCDEF" 

30 INPUT "Enter filename"; f$(1) 

40 IET £$(1)=£$(1): PRINT f$(1);T 
AB 12;USR 23296 

50 IET hash=PEEK 23728: LET h=IN 
T (hash/16): LET 1=hash-16*h 

60 PRINT TAB 17;h$(h+1) sh$(1+1) 

70 GO TO 30 

80 DATA 42,77,92,1,0,10, 126,35 

90 DATA 169,7,79,16,249, 121,183 

100 DATA 32,1,60,79,50,176,92, 201 


Except.during SAVEing, if a file exists 
its hash code” MOST also exist in the 
HIT. A corrupted HIT results in files 
being inaccessible via the DOS and so if 
you lose sector O of the directory track 
the disk will be unusable. A sector 
editor such as that written by Ve A. 
O'Farrell (a member of SURF) can be used 
with great success to recover lost data. 
There are two degrees of corruption of 
data: 

a. the sector ID (sector and track 
number, side number, CRC, etc) is corr- 
upted. This is the most serious case as 
the sector is utterly useless and needs 
to be reformatted. A disk editor will 
fail to read it. 

b. The actual sector data has been 


corrupted. 

The sector can be rebuilt by 
re-writing the disk specification 
(tracks, sectors, sides, etc) and the 
HIT. You needn't spend time rebuilding 


the GAT but make sure you don't SAVE any 
more files on that disk. Go through the 
remaining 9 sectors of the directory and 
write down (in the right order!!) all 
the filenames of the existing files. You 
will see that the filename starts on the 
fourth byte of each 32-byte group. If 
bit 7 (MSB) of the third byte (the 
"filetype") is set, the entry is deleted 
and the hash code mst be zero (ega 
deleted BASIC program is 80 hex, CODE is 
8% hex, a sequential access file is 34 
hex, etc). Bach sector will give you 16 
file names. You can then run the BASIC 
program above to produce the hash codes 
for each filename. Return to the disk 
editor and reconstruct the HIT, making 
sure that deleted entries have a zero 
code. If a whole sector of the direc- 
tory has gone (eg all zeros), also make 
sure that the 16 HIT bytes corresponding 
to that sector are zero. Unfortunately 
there is no easy way of recovering files 
whose directory entries have gone! Once 
you have reconstructed the "master" 
directory (sector O) your disk should 


CATalogue. You should even be able to 
LOAD files! However, the lack of a 
sensible GAT means that you could 


over-write your files as their space 
might appear to be free. Your next step 
should then be a global MOVE on toa 
blank disk, test the latter disk to see 
that all your files are there and, 
finally, re-formatting your original 
(corrupted) disk. If the disk editor 
program cannot read sector O then you 
canot reconstruct that sector. Prepare 


a disk with identical characteristics to 
the corrupted one and copy all the 
readable sectors on to it. All you have 
to do then is to reconstruct the HIT and 
finally MOVE all the files onto yet 
another disk. 

<.. I seem to have run out of room (no 
more sectors in this SURFnews) and 
Julian will never forgive me! (he is 
ever so fierce! Particularly when there 
isn't enough room left for him to 
gossip...) In the next SURFnews (which 
will be out on time, etc etc - cross my 
heart etc etc ...) I shall describe the 
individual directory entries (although 
you will probably have worked that out 
for yourself) as well as reading a 
sector and writing via hook codes. 


HAVE FUN !! 


BITS AND PIECES 


¿de Graig L Davis of Bloomsburg, PA, 
wants to know whether SPDOS V1.2 will 
condense BASIC programs which have a lot 
of numbers in them. The new command 
CLEAR O will convert all rumber forms to 
to NOT PI (=0), SGN PI (=1), INT PI (=3) 
and VAL "nn", thus saving 3 to 5 bytes 
per number. In answer to his further 
query, a switch can be fitted to. the 
2026 SPDOS board to liberate the 
cartridge slot. More information is 
available from RAMEX. 

Le 2 fe SPDOS can now be converted for 
the 128k Spectrum. It needs a slight 
modification to the hardware, a new 
EPROM anda new system disc. Abbeydale 
Designers will do this for 145.00 + VAT. 
This version of SPDOS will boot up in 
the 48k mode but the 128k of RAM is 
useable since the 16k pages can be 
swirched in and out from BASIC or 
machine code. This. is therefore not a 
FULL Spectrum 128k implementation. 

¿cor You may have heard that OCP, the 
producers of Art Studio and other 
top-line Spectrum programs have. gone 
into liquidation. Their programs are 
still available, however, and under 
development for the 128k Spectrum. If 
you want more information on this and 
other OCP programs, the easiest way is 
to write c/o Abbeydale Designers, PO Box 
124, Reading, Berks, UK. 


from RHJ Brown, Cambridge: 

I am interested in the new version of 
SPDOS and would like a little more 
information. Are there any incompat- 
ibilities with SPDOS 1? Can one, having 
loaded issue 2 DOS, then load, save, 
move, etc from a disc formatted by issue 
12 The other item in SURF 2 which I 
found particularly interesting was the 
reference to random access filing. I 
have needed to store data in records 
varying in size from about 100 to 1500 
bytes, to date about 100kbytes and 
increasing. So far I have used tasword 
files accessed by reference to a printed 
list of file contents and the slow 
tasword word-finding routine. I should 
be most grateful for a little more 
information on this item since my knowl- 
edge is clearly insufficient. For exam- 
ple, I do not understand the term “calcu 
lated filename". Perhaps you know of a 
publication I could obtain which would 
be useful. Incidentally I used, success 
fully, the technique mentioned in SURM 
to save and load tasword with extra 
fonts. One loses the ability to save 
files on disc, but this is unimportant 
since our use of alternative fonts is 
entirely for personal correspondence for 
wnich file copies are not needed. 


--In answer to this one, in each 
version of SPDOS we only make additions 
to the DOS! You don't have to re-record 
all your files to maxe them compatible. 
. «The easy route to random access filing 
is to buy acopy of the SPDOS Utility 
Disc described in SURFS. Not only is 
there a new command (POINT) on that disc 
but there is a program which sets up 2 
list of names and addresses using random 
filing. 

A calculated filename can be one of 
several things. Basically in each 
instance you are using some number in 
the file name on which you can do 
further calculations to find the start 
of the main or sub-records within the 
file. A technique used in the demo prog 
on SPUD, for instance, is to set up an 
enpty or dummy file on the disc using an 
empty string or sequence of empty 
strings which can then be filled with 
(eg) fields of 4 file entries, each 123 
bytes long, contained within a single 
string 511 bytes long. It is the locat- 
ion of these strings and sub strings 
which involves the calculation, since 


programs 


each is identified by a number which is 
related to, but not iđentical with, its 
position in the file as determined by 
counting bytes from one end. It's just 
like using a calculated GO SUB from a 
menu, where the menu option can be a 
single digit which is then multiplied by 
(say) 1000 to give the line number of 
the required routine. The next thing, of 
course , is to use space in each string 
to contain information about the 
position of other. strings in the list, 
enabling even faster access. This is the 
"linked list" approach, and probably the 
best book for finding out about that is 
Knuth's "Fundamental Algorithms" (if you 
can find a copy! The editor of this 
esteemed Organ has a copy on loan and 
would dearly like to own a copy of the 3 
volumes so far published. Any offers?). 


SURFWews , 
Abbeydale Designers. 


To whom it may concern: 


Report andcry for help from New 
Jersey, USA. I have been a SPDOS user 
for some six weeks now, and am just 
coming up for air. 


I have a good-sized collections of 
which I have written, covering 
the financial and statistical operations 
of my business and various personal 
affairs. The conversion to SPDOS was 
quick and painless and, once finished 
with this task, I disconnected forever 
the weak link in my computer operations: 
the cassette deck, and put it forever 
out of my sight. That left me with two 
additional tasks: to learn the "overlay" 
system and to learn the use of 
sequential file programming. The former 
was accomplished quickly. The latter has 
me crazy! 


With an apology in advance for the 
adverse criticism, the documentation 
provided by Ramex International, the USA 
importer of SPDOS, (which they 
presumably get from you) is quite clear 
and helpful....IF one already knows how 
to operate in a DOS language. Since my 
experience with computers has been 
limited entirely to Sir Clive's two 
marvels, and SPDOS was the first (and as 
far as I know, the only) DOS to be 


offered for the Spectrum/TS 2068, my 
knowledge was zero. With that wonderful 
foundation and six weeks of struggling, 
I have yet to comprehend the mysteries 
of sequential file programming. 


"Over here" there are no publications 
available to aid one in learning SPDOS, 
though I can count at least 200 in the 
book shops dealing with IBM's DOS and 
half as many for APPLE and COMMODORE 
DOS. Might you be able to recommend some 
publications (and a source for 
purchasing them by mail) to supplement 
your meager manual and help me raise my 
knowledge of sequential file programming 
to that of my Sinclair BASIC? 


The sole "game" software I ever 
purchased was Psion's Flight Simulator, 
a source of many hours of enjoyment, but 
find that with the SPDOS interface 
connected, the cartridge is ignored and 
I am grounded. I realise that I could 
disconnect the interface every time I 
have the urge to "fly", but I do not 
have that much faith in any edge 
comector and prefer to leave it in 
place, barring emergencies. Do you —— 
or any of your USA readers —— have any 
suggestion as to how I might 10Ad this 
software with the i/f in place, or 
alternatively to LOAD it and SAVE it to 
disc? 


Apart from these two "problems" I am 
delighted with my SPDOS system and 
wonder how I put up with tape operations 
for nearly two years. Now, if I could 
just master the art of Sequential File 


Yours sincerely, 
SCIENTIFIC & REGULATORY SERVICES 
Dr. Donald J. Flaster. 


[As usual, any letters can be forwarded 
to Dr. Master] 


KKK KR KK KKK KHER KHKRHEKEHSE 
* The SPUD Utilities Disk has Random * 
* Access, Disc to Tape, Modified, CAT, * 
* Code Dump, 42/51 col. text driver & * 


* more. From Abbeydale Designers. * 
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*** MERGING FILES IN MASTERFILE *** 


If you bought SPDOS from Watford you 
will have had a copy of. MASTERFILE on 
the master DOS disc that came with it. 
But one of the annoying problems with MF 
is that there is no order for merging 
files. The program which follows was 
put out in the Spectrum area of Micronet 
as a public domain program, intended for 
use with microdrives. I have made the 
necessary alterations for SPDOS/KDOS, 
though I haven't tried it and so cannot 
guarantee it. The original program was 
compacted, but if you have the updated 
version of SPDOS (v1.2) it's quicker to 
type in the program in the "long" (ie 
simpler) form as below, then use the 
"PRINT #4: CLEAR O" command to turn all 
numbers to their VAL"n" equivalents and 
use the INT PI, SGN PI, etc notations. 


10 CLEAR 49647: DIM n$(5,10): 
LET z=32000: LET c=4 

15 PRINT AT 1,103"ME MERGE": 
PRINT 

20 BEEP .5,20: INPUT "Primary 
MF file name?"; LINE n$(1); BEEP 

5,20: INPUT "From drive no.?"; 
d1 

30 PRINT #4: LOAD n$(1) DATA p 
$(): PRINT d1: PRINT "MF file " 
; INVERSE 1;n$(1);" loaded to p$ 


40 LET lp=LEN p$: PRINT "(leng 
th-";1p-1;" bytes)" 

50 BEEP .5,20: INPUT "Name of 
primary datafile (primar 
y MF file name.)"; LINE n$(2) 

60 IF n$(2)=n$(1) THEN GO TO 5 
O 


70 BEEP .5,20: INPUT " SAVE to 
drive no.?";d2 

80. PRINT#4: OPEN fc,n$(2): PRI 
NT d2 

90 INPUT #c;p$(1 TO p-1) 

100 PRINT #4: CLOSE He 

110 DIM p$(1): PRINT : PRINT "D 
ATAFILE "; INVERSE 1; n$(2);" sa 
ved on drive ";d2 

120 BEEP .5,20: INPUT "Secondar 
y MF file name?"; LINE n$(3): BE 
EP .5,20: INPUT "From drive no.? 
".d3 

130 PRINT #4: LOAD n$(3) DATA s 
$(): PRINT d3: PRINT : PRINT "MF 

file "; INVERSE 1:n$(3): INVER 
SE 1:" loaded to s$" 


d 


+ 


140 LET 1ls=LEN s$: PRINT #1;"PL 
EASE WAIT" 

150 FOR n=1s-1 TO 1 STEP -1 

155 PRINT #13AT1,24; INK 4;n;" 

n 


160 GOT TO (170 AND CODE s$(n)< 
>255)+(180 AND CODE s$(n)=255) 

170 NEXT n 

180 IET Im=(1p-1+1ls-n): LET 1t= 
ls 

190 IF lm>z THEN GO SUB 560 

200 INPUT ;; PRINT " (length-"; 
lt-nz" bytes)" 

205 FOR f=1 TO 20: BEEP .2,10: 
NEXT f 

210 BEEP .5,20: INPUT "Name of 
secondary datafile (<>secon 
dary MF file name.)"; LINE n$(4) 
is IF n$(4)=n$(1) THEN GO TO 2 

230 BEEP .5,20: INPUT "SAVE to 
drive no.?":d4 

23) IF CODE s$(1s)<>255 THEN LE 

T s$(1s)=CHR$ 255 

T40 PRINT #4: OPEN #c,n$(4): 
PRINT d4 

250 INPUT #c;s$(n+1 TO ls) 

260 PRINT #4: CLOSE #e 

270 DIM s$(1): PRINT : PRINT "D 
atafile "; INVERSE 15n8(4); INVE 
RSE 1;" saved on drive ";d4 

280 DIM £$(1m) 

290 BEEP .5,20; INPUT "Name of 
merged file? ga ot 
her filenames)": LINE n$(5): 

UT "SAVE to drive no.?"3d5 

300 PRINT #0;AT 1,10; FLASH Tan 
PLEASE WAIT" 

310 PRINT #4: OPEN #c,n$(2): 
PRINT d2 

320 FOR p=1 FO 1p-1 

325 PRINT #1;AT 1,24; INK 4:p3" 

n 


330 LET f$(p TO p)=INKEYS$#c 

340 NEXT p 

350 PRINT #4: CLOSE ¿fc 

360 PRINT #4: OPEN ffc,n$(4): PR 
INT a4 

370 FOR p=lp TO lm 

375 PRINT #1;AT 1,24; INK 4;p;" 


380 LET f$(p TO p)=INKEYS fc 

390 NEXT p 

400 PRINT #4: CLOSE #c 

405 FOR f=1 TO 20: BEEP .2,10: 
NEXT f: LET £$(35 TO 44)=n3(5) 

410 PRINT #4: SAVE n$(5) DATA f 
$(): PRINT a5 


420 PRINT : PRINT "Merged MPF fi 
le "; INVERSE 13n$(5); INVERSE 1 
i saved on drive ":d5: PRI 
NP * (length-"; mz" bytes)" 

430 BEEP .5,20: INPUT " ERASE p 
rimary MP file?(y/n)"; LINE a$ 

440 IF a$<>"y" AND aS<>'n" THEN 

GO FO 430 

450 IF ag="y" THEN PRINT #4: ER 
ASE n$(1): PRINT di 

460 BEEP .5,20: INPUT " ERASE p 
rimary datafile?(y/n)"; LINE a$ 

470 IF a$<>"y" AND a$<>"n" THEN 

GO TO 460 

480 IF a$=-" " THEN PRINT #4; ER 
ASE n$(2): PRINT d2 

490 BEEP .5,20: INPUT " ERASE s 
econdary MF file?(y/n)"; LINE a$ 

500 IF a$<>"y" AND a$<>"n" THEN 

GO TO 490 

510 IF a$="y" THEN PRINT #4: ER 
ASE n$(3): PRINT a3 

520 BEEP .5,20: INPUT " ERASE s 
econdary datafile?(y/n)"; LINE a 
$ 

530 IF a$<>"y" AND a$<>"n" THEN 

GOTO 520 

540 IF a$="y" THEN PRINT #4: ER 
ASE n$(4): PRINT a4 

550 BEEP 3,30: STOP 

560 LET lt=z-lpt1: IET ls=1t+1: 

PRINT "Merged file >22k 

Secondary file truncated 
o's FOR f=1 TO 20: BEEP .2,-20: 
NEXT f: LET lm=z: RETURN 
9995 STOP 
9996 PRINT #4: SAVE "MF merge” L 
INE 1 


e G Clarke of Papua New Guinea has 
lots of programs on tape and wants to 
know how successful the tape-to-disk 
transfer which comes with KDOS is. It 
will copy programs less than 32k to disk 
even if it is copy-protected. Even if 
you can't break in to it you can then 
use the utility on the SPUD disk which 
transforms all tape and microdrive 
commands to SPDOS/KDOS notation. But 
some types of protection include 
writing over the system variables and 
oter such nasties which can be difficult 
o break in to. Also the KDOS system 
uses about 700 bytes in the microdrive 
control area of memory. So you can't 
use programs which fill memory entirely 
(which you can, of course, with SPDOS, 
ad that does mean overwriting the 
DOS). 
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